home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / list62a.arc / LISTMOD.TXT < prev    next >
Encoding:
Text File  |  1987-05-14  |  7.5 KB  |  167 lines
  1.  
  2.                                                         LIST  Version 6.2a
  3.                                                               May 14, 1987
  4.  
  5.                         Addendum
  6.                         --------
  7.  
  8.     1.  Reassigning keys
  9.  
  10.         This information is offered to those of you who wish to
  11.         modify LIST in special ways.  You do not need this
  12.         information to use LIST.
  13.  
  14.         LIST performs a function for every character that can be
  15.         entered at the command line prompt.  There are 128 regular
  16.         characters and 131 extended characters.  The regular characters
  17.         are numbered from 0 to 127, and they include the letters A-Z,
  18.         a-z, the numbers, and the rest of the usual single characters
  19.         found on your keyboard.  The extended characters represent
  20.         special function keys and combinations of keys, such as F1,
  21.         alt-X, ctrl-A, and the cursor positioning keys.
  22.  
  23.         The WHAT table in LIST has a one byte entry for each of the
  24.         characters. This byte is a number from 0 to 53 that represents
  25.         the identification of a routine that performs a function.
  26.  
  27.         For example,
  28.  
  29.           - the ESCape key has a value of 27 (hex 1B) and its
  30.             value in the WHAT table is 16 (10 hex). Routine number 16
  31.             is called "Done".  The "Done" routine exits to DOS.
  32.  
  33.           - the Q key has a value of 81 (51 hex) with a routine value
  34.             of 15 for the "Close" routine. The "Close" routine ends
  35.             viewing of the current file and tries to display the next
  36.             file, i.e. wildcards used for the filename. There is also
  37.             a lower case letter q, so be sure to change both entries.
  38.  
  39.  
  40.         To change the function that a command character performs, you
  41.         change the value in the WHAT table for the routine that the
  42.         character invokes.
  43.  
  44.         For example, to change the ESCape key to act like the Q key,
  45.         you change the routine value for ESCape from 16 (10 hex) to
  46.         a 15 (0F hex).
  47.  
  48.         To find the location of the routine value in the WHAT table,
  49.         first determine the value of the character, e.g. ESCape is
  50.         27 (1B hex), and then add that to the location of the WHAT
  51.         table (362 hex); or, 1B + 362 = 37D hex. Finally, use DEBUG
  52.         to change the byte at that location (37D hex) from a 10 hex
  53.         to a 0F hex.
  54.  
  55.         For example,
  56.  
  57.           debug list62a.com             ; use appropriate file name
  58.           -e 37d 0f                     ; change ESC to routine 15
  59.           -w
  60.           -q
  61.  
  62.  
  63.     The routine ids are:
  64.  
  65.     Value Key(s)    Title        Description of function performed
  66.     ----- --------- ----------   ------------------------------------------
  67.       0             Beeper       Error, undefined command
  68.       1   alt-A     AltA         Toggle APXCORE/DD/TV interface
  69.       2   alt-E     AltE         Toggle EGA 43-line mode
  70.       3   alt-F     AltF         Get new filespec
  71.       4   alt-J     AltJ         Toggle Junk filter
  72.       5   alt-L     AltL         Toggle pre-Load
  73.       6   alt-T     AltT         Toggle TABs expansion
  74.       7   alt-W     AltW         Toggle Window
  75.       8   alt-X     AltX         Exit to DOS, restore screen
  76.       9   U/up      Back         Position to previous line
  77.      10   End       Bottom       Position to end of file
  78.      11   F5        ChgBack      Change top/bottom line background color
  79.      12   F6        ChgFore      Change top/bottom line foreground color
  80.      13   c-home    CHome        Position to specified line number
  81.      14   alt-C     Clone        Rewrite LIST.COM with new options
  82.      15   Q         Close        Quit current file, display next file
  83.      16   ESC F10   Done         Exit to DOS
  84.      17   N down    Down1        Position to next line
  85.      18   X         DoneX        Exit to DOS, clear screen
  86.      19   alt-H     DumpHex      Toggle Hex display mode
  87.      20   8         Eight        Leave hi-bit
  88.      21   \         Find         Search for text, any case matches
  89.      22   F2        FindBack     Change Find/Scan background color
  90.      23   F4        FindFore     Change Find/Scan foreground color
  91.      24   alt-M     Flash        Toggle monitor rescan testing
  92.      25   K         Flush        Toggle keyboard flush (type ahead)
  93.      26   alt-G     GotoDOS      Invoke DOS command (shell)
  94.      27   L left    Left         Scroll left 10 columns
  95.      28   -         MinusNum     Position back by number of lines
  96.      29   enter     NxtPage      Display next page
  97.      30   +         PlusNum      Position forward by number of lines
  98.      31   P         Print        Print current screen or marked lines
  99.      32   F1 H ?    Help         Display Help screen
  100.      33   F3        ReScan       Search for next occurance of text
  101.      34   R right   Right        Scroll display right 10 columns
  102.      35   alt-R     Ruler        Display ruler marks on top line
  103.      36   /         Scan         Search for text, same case
  104.      37   F9        ScanBack     Search for previous occurance of text
  105.      38   c-left    Scroll0      Reset scroll to column 1, full left
  106.      39   F7        SetBack      Change normal line background color
  107.      40   F8        SetFore      Change normal line foreground color
  108.      41   7         Seven        Strip hi-bit
  109.      42   C         Share        Toggle closing of files
  110.      43   *         Star         Toggle special * filter
  111.      44   Home      Top          Position to top of file
  112.      45     up      Up1          Position back one line
  113.      46   W         Wrapper      Toggle display of wide lines
  114.      47   alt-D     WriteFile    Write marked lines to a file
  115.      48   alt-M     MarkLines    Mark top line of display
  116.      49   alt-U     UnmarkLines  Unmark lines
  117.      50   alt-B     MarkBottom   Mark bottom line of display
  118.      51   ctrl-pgup Review       Display previous file
  119.      52   ^         RevFind      Like Find but initiates search backwards
  120.      53   v         RevScan      Like Scan but initiates search backwards
  121.  
  122.  
  123.  
  124.     2.  Helpful locations for DEBUG:
  125.  
  126.         035E    WHAT eye-catcher
  127.         0362    value of routine for character 0, nul (00 hex), Beeper
  128.         0372    value of routine for character 16, dle (10 hex), Beeper
  129.         0382    value of routine for character 32, space (20 hex), NxtPage
  130.          .
  131.          .
  132.          .
  133.         03D2    value of routine for character 112, p (70 hex), Print
  134.  
  135.  
  136.         Extended characters:
  137.  
  138.         03E2    value of routine for character 0, undefined (00 hex), Beeper
  139.         03F2    value of routine for character 16, alt-Q (10 hex), Beeper
  140.         0402    value of routine for character 32, alt-D (20 hex), WriteFile
  141.          .
  142.          .
  143.          .
  144.         0462    value of routine for character 128, alt-F9 (80 hex), Beeper
  145.  
  146.  
  147.         You can determine the value of a character (or key sequence) by
  148.         referring to your BASIC manual (appendix G usually).
  149.  
  150.  
  151.     3.  Supplied files.
  152.  
  153.         Sample files for modifying LIST are supplied. To apply a
  154.         modification, the DOS DEBUG program must be available in
  155.         the current PATH. Enter the name of the modification (.BAT)
  156.         file and DEBUG will be invoked to apply the modifications.
  157.  
  158.              ESC2Q    BAT    Changes ESCape to act like Q
  159.              ESC2Q    DBG    Input to DEBUG
  160.  
  161.              UNBEEP   BAT    Disables sounds and beeps
  162.              UNBEEP   DBG    Input to DEBUG
  163.  
  164.              MARKMOD  DBG    Changes attribute used for marked lines
  165.              MARKMOD  BAT    Input to DEBUG
  166.  
  167.